例セグメント・フィード

セグメントとはマーチャントが定義する有意な属性、例えば年齢、性別、行動、購入金額などによるユーザーのグループです。RecomendとEngageはどちらも、推奨商品やコンテンツの選定にセグメントを活用します。加盟店は、フィードを通じて事前に定義されたセグメントを提供できます。このドキュメントでは、フィードの形式と、そのデータをAlgonomyに提供する手順について説明します。

このフィードは毎日アップロードする必要はありません。セグメントデータに更新があった場合のみアップロードしてください。通常は週単位、月単位、またはその他の適切な間隔でアップロードするようにスケジュールされます。あるいは、セグメントはAPIまたはJavaScriptタグを介して送信することも可能です。詳細については、Algonomyの担当者にお問い合わせください。

セグメントは、セグメントIDとセグメント名の組み合わせとして定義され、それぞれの組み合わせは一意である必要があります。セグメントの詳細については、セグメントを参照してください。

セグメント

カタログフィードやコンテンツフィードは、パイプ区切りのCSVファイル形式（拡張子.txt）を使用するのに対し、セグメントフィードはJSONデータとして送信されます。

セグメントは、ユーザーIDとそれに関連付けられた値の2つの項目からなるJSONオブジェクトとして、ユーザーIDとともに渡されます。関連付けられた値は、セグメントIDと名前から構成されるハッシュのリストである別のオブジェクトに格納されます。

• セグメントID：セグメントの一意の識別子

• セグメント名：セグメントIDに関連付けられた、人間が読みやすい名前。これは省略可能です。セグメント名を指定しない場合は、代わりに空の文字列（"") ）を使用してください。

セグメントIDが一度名前にマッピングされると、別の名前で再利用することはできません。

フィードファイル

ファイル仕様

パーソナライゼーションプラットフォームは、ユーザープロファイルサービスに対して、フルフィード（完全上書き）とデルタフィード（増分更新）の両方をサポートしています。

セグメントに加えて、このプラットフォームは、ユーザープロファイル一括アップロードAPIまたはユーザープロファイルエンリッチメントAPIを介して、ユーザー属性、ユーザーリンク、およびユーザー設定の取り込みもサポートしています。バッチアップロード機能を使用すると、ユーザーIDと所属するセグメントを関連付けることで、各ユーザーのセグメントデータを読み込むことができます。このデータは、プラットフォーム内のユーザープロファイルを更新するために使用されます。

セグメントに加えて、このプラットフォームは、[ユーザープロファイル一括アップロード]または[ユーザープロファイルエンリッチメントAPI]を介して、ユーザー属性、ユーザーリンク、およびユーザー設定の取り込みもサポートしています。

フィードファイルは、1行ごとに1つのJSONオブジェクトを記載する必要があります。各オブジェクトは2つのフィールドを持ちます:

サンプル

{"userId": "13579", "value":{"seg2134":"Dog Owner", "seg50plus":"High Spender", "Platinum": "Platinum Member"}}

Note: 各ユニークなセグメント識別子には、固有のコンテキストや値が付与されます。

Upload Segment Feed Data

You can upload segment feed data using either FTP or SFTP, depending on your use case and scale.

Segment feeds can be uploaded using the standard FTP-based ingestion process, where the JSON file is transferred directly to the FTP server and then processed using custom commands such as HIVEUPLOAD. This method is suitable for simple, manual uploads or smaller datasets and follows the same approach as other feed uploads. For more details on connecting to the FTP server and uploading files, refer to Importing Data with FTP.

Segment feeds can also be uploaded using SFTP-based offline ingestion, which is the recommended approach for secure and large-scale data processing. In this method, files are uploaded as compressed archives along with a metadata file that defines the ingestion command (such as UPSBATCH with the rr-segments attribute). SFTP ingestion provides better structure, automation, and error handling through directory-based processing and asynchronous execution. For more details, refer to SFTP Offline Data Ingestion.